/* 
        This example shows how to get the resolved path
        on each member of the external files list and how to 
        change the path on the fly.
        Note: To see the UNC path in action, change the location 
        of the NewFile variable to a valid UNC path 
        (for example, "\\\\mymachine\\toto\\Man_Face.emdl") that is 
        mapped to a drive letter (such as Q:) and rerun the example.
*/
NewScene( null, false );
// ---------------------------------------------------------------------------
//      Setup
//
// First import a model so we have some external files to find
var FPath = XSIUtils.BuildPath(
        Application.InstallationPath( siFactoryPath ),
        "Data", "XSI_SAMPLES", "Models", "Man_Face.emdl"
);
var oISIVTColl = ImportModel( FPath, null, true );
// Now copy the reference-model file to a local directory
var NewFile = "C:\\temp\\Man_Face.emdl";
var fso = new ActiveXObject( "Scripting.FileSystemObject" );
fso.CopyFile( FPath, NewFile, true );
// ---------------------------------------------------------------------------
//      Using the FileReference Object
//
// Get the collection of all external files on the scene
var oModel = oISIVTColl.Value("Value");
var l_extFileList = oModel.ExternalFiles;
// Loop through the list and change only the 
// referenced model file to point to the one we put in c:\temp
for ( var i=0; i<l_extFileList.Count; i++ ) {
        // Get the FileReference object and print the path
        printFileInfo( l_extFileList(i) );
        // Change the path to point to the temp directory
        if ( l_extFileList(i).FileType == "Models" ) {
                // Make sure the original path exists, change it to 
                // the new one, and print the new path for confirmation
                if ( l_extFileList(i).FileExists() ) {
                        var OldPath = l_extFileList(i).Path;
                        Application.LogMessage( "ORIGINAL PATH: " + OldPath );
                        l_extFileList(i).Path = NewFile;
                        Application.LogMessage( "MODIFIED PATH: " + l_extFileList(i).Path );
                        // Restore original name
                        l_extFileList(i).Path = OldPath;
                }
        }
}
// ---------------------------------------------------------------------------
//      Convenience function
//
function printFileInfo( in_file ) {
        try {
                Application.LogMessage( Application.ClassName(in_file) );
        } catch(e) {
                if ( typeof(in_file).toLowerCase() == "object" ) {
                        Application.LogMessage( in_file.FileType );
                } else {
                        Application.LogMessage( typeof(in_file) );
                }
        }
        if ( in_file.FileExists() ) {
                // Get the original path 
                var o_path = in_file;
                // Get the resolved path
                var r_path = o_path.ResolvedPath;
                // Get the UNC path
                var u_path = o_path.UNCPath;
                // Print all three results
                Application.LogMessage( "ORIGINAL: " + o_path );
                Application.LogMessage( "RESOLVED: " + r_path ); 
                Application.LogMessage( "UNC     : " + u_path );
        } else {
                Application.LogMessage( "Skipping non-existent file" );
        }
}
// ---------------------------------------------------------------------------
//      OUTPUT
//
// INFO : FileReference
// INFO : ORIGINAL: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl
// INFO : RESOLVED: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl
// INFO : UNC     : <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl
// INFO : ORIGINAL PATH: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl
// INFO : MODIFIED PATH: C:\temp\Man_Face.emdl
// INFO : FileReference
// INFO : Skipping non-existent file